home *** CD-ROM | disk | FTP | other *** search
/ What PC? 1996 June / What PC June 1996.iso / psion / readme.txt < prev    next >
Text File  |  1996-03-13  |  7KB  |  177 lines
  1.  
  2.  
  3.      =====================================================
  4.      NOTE: The What PC databases are in the M subdirectory
  5.      =====================================================
  6.  
  7.  
  8.  
  9.                       README.TXT for S3aEMUL.EXE
  10.                       ==========================
  11.  
  12. This file explains how to run the program S3AEMUL.EXE, which provides
  13. an emulation of Psion's S3a software on sufficiently powerful PCs.
  14.  
  15. Files in the emulator:
  16. ----------------------
  17. S3AEMUL is distributed in the form of a .ZIP file containing the
  18. following files:
  19.  
  20.     readme.txt          this documentation file
  21.     licence.txt         user licence agreement
  22.     s3aemul.exe         the emulator top level
  23.     epoc.dll            used by the emulator (contains EPOC)
  24.     epoc.rmi            used by the emulator (rest of OS and APPS)
  25.     hhserver.par        configures the emulator
  26.     rtm.exe             run-time support
  27.     dpmi16bi.ovl        run-time support
  28.  
  29. Licence agreement - important
  30. -----------------------------
  31. Note: before using this software, you must read and agree with the
  32. terms of the accompanying file LICENCE.TXT.
  33.  
  34. Intended purpose
  35. ----------------
  36. Note: the intended purpose of S3AEMUL is as an unsupported tool for
  37. software developers.  Treat it with the caution you would normally
  38. accord to unsupported software development tools - be sure to have
  39. backups of any data on your PC, before using S3AEMUL.
  40.  
  41. That said, it has been the experience of developers who have already
  42. used S3AEMUL that no significant data loss has resulted from the use
  43. of this tool.
  44.  
  45. However, Psion cannot offer any warranties or guarantees on this
  46. point.  In particular, users are warned not to try running S3AEMUL
  47. from inside Windows, OS/2, or Windows NT.
  48.  
  49. Installation of the software
  50. ----------------------------
  51. You should copy the following files into the same directory on your
  52. PC: s3aemul.exe, epoc.dll, epoc.rmi, hhserver.par, rtm.exe, and
  53. dpmi16bi.ovl.
  54.  
  55. Rename S3aEMUL.EXE if you like, but don't rename any other file.
  56.  
  57. Limitations of the emulator:
  58. ----------------------------
  59.     You must be running a 386 (at least) PC.
  60.     You must have at least 4MB ram.
  61.     Only VGA graphics support.
  62.     S3aEMUL will not run in a DOS box in Windows (it will "violate
  63. Windows system integrity").
  64.     S3aEMUL will not run under Windows NT or O/S 2.
  65.  
  66. To run the emulator:
  67. --------------------
  68. Go to the directory including S3aEMUL.EXE and type "S3aEMUL".
  69.  
  70. NB The emulator will behave oddly if it cannot find an M:.
  71. So be sure that one is available (create one using SUBST if you need
  72. to), although there doesn't have to be anything special in it.
  73. (See below for notes on the DOS SUBST command.)
  74.  
  75. To exit the emulator:
  76. ---------------------
  77. Press and hold down Ctrl-Alt-Esc simultaneously.
  78. Or execute a program (IMG or OPO) that calls HwExit (call($168e)).
  79.  
  80. **** Ctrl-Alt-Z is an alternative to Ctrl-Alt-Esc.
  81.  
  82. When the emulator exits:
  83. ------------------------
  84. The message "Fatal application error 00" will be displayed.
  85. This is perfectly normal (no error has, in fact, occurred).
  86.  
  87. Other fatal application errors:
  88. -------------------------------
  89. These almost invariably mean that insufficient ram was available.
  90. For example, ram allocated to a ram drive is inaccessible to S3aEMUL.
  91.  
  92. Special keys inside the emulator:
  93. ---------------------------------
  94. F1 is System, F2 Data, ..., F8 Sheet, F9 Menu, F10 Help, F12 Diamond
  95. F11 simulates the machine being switched off then on (only has any
  96. effect when a password is set).
  97. Alt is the Psion key.
  98. You can use the Insert key as an alternative to Shift-System.
  99.  
  100. Other limitations of the emulator:
  101. ----------------------------------
  102. Limited emulation of the WVE sound system.
  103. Differences at the low-level filing system level.
  104. Address trapping is implemented differently.
  105.  
  106. Run-time errors with the emulator:
  107. ----------------------------------
  108. The low-level memory manager inside S3aEMUL may generate exceptions,
  109. known as "run-time errors", if various error conditions arise - eg
  110. programs attempting to read or write outside the limits of the code
  111. and/or data segments.  (On a real S3a, these conditions would lead to
  112. "panic"s, but they are caught earlier, at a lower level, inside
  113. S3aEMUL.  This is not to say, incidentally, that *all* S3a panics are
  114. converted to S3aEMUL exceptions, only a fixed minority.)
  115.  
  116. When a run-time error of this sort occurs, the whole emulator stops
  117. at once, and all data in all programs is lost (though not data saved
  118. to file).  The emulator stops so suddenly that the screen will be
  119. left in graphics mode.  To return it to standard character mode, type
  120. eg      
  121.         MODE co80
  122. (you'll have to type this "blind", since the characters you type
  123. won't be echoed onto the screen until after the command is processed).
  124.  
  125. When a run-time error occurs, some part of the memory of the PC may
  126. on occasion be left tied up, even after S3aEMUL has exited.  (Use eg the
  127. DOS MEM command to find out if this is the case.)  Reset your PC if
  128. this becomes a problem.
  129.  
  130. Note that under normal circumstances, S3aEMUL will not encounter a
  131. run-time error - only if a program contains a bug.  However, if you
  132. use S3aEMUL to test programs under development, you may well encounter
  133. this situation.
  134.  
  135. Remote Link:
  136. ------------
  137. Note that you can turn on Remote Link in the System Screen and gain
  138. access to an attached S3a (or other Sibo computer) as REM::.
  139.  
  140. By default, this connection presupposes use of COM1.  However, if you
  141. type "-p2" into the "Extra parameters" line in the "Remote link"
  142. dialog in the System screen inside S3aEMUL, COM2 will be used instead.
  143.  
  144. Notes about SUBST:
  145. ------------------
  146. See your DOS manual for full details.
  147. Example syntax is
  148.     SUBST M: C:\PSION
  149. To change a subst, you first have to "delete" it, eg using
  150.     SUBST M: /D
  151.  
  152. Note that before you can SUBST to M:, the LASTDRIVE setting in
  153. CONFIG.SYS must be set as least as high as M.  (If you have to change
  154. your CONFIG.SYS, you will have to reboot your PC before this takes
  155. any effect.)
  156.  
  157. You may also find it convenient to SUBST A: or B: whilst S3aEMUL is
  158. running, to lessen the amount of access made by S3aEMUL to your floppy
  159. disk drives.
  160.  
  161. Troubleshooting:
  162. ----------------
  163. If you have problems running S3aEMUL:
  164.     disconnect any serial mice and/or remove their drivers
  165.     remove any ramdrives from your PC configuration
  166.     remove other ram-guzzlers from your PC configuration
  167.     re-read this document (sorry if this sounds condescending).
  168.  
  169. Technical support for S3aEMUL:
  170. ------------------------------
  171. Psion regrets that no technical support is available on the use of
  172. S3aEMUL, whether by post, fax, telephone calls, or EMAIL.
  173.  
  174. The sole exceptions to this are that questions raised about S3aEMUL in
  175. the PSION conferences on CIX will generally be answered within a few
  176. days.
  177.